home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 25 / AMIGAplus Sonderheft 25 (2000)(Falke)(DE)(Track 1 of 4)[!].iso / PublicDomain / Anwendungen / MSCalendar / MSCal.dok < prev    next >
Text File  |  1991-11-21  |  16KB  |  357 lines
  1. ==========================================================================
  2. ============================== MSCal V1.10 ===============================
  3. ==========================================================================
  4.  
  5.                     Ein Free-Ware Kalender Utility von
  6.              Markus Stipp, (c) Copyright 1991 by Markus Stipp
  7.                           alle Rechte vorbehalten
  8.  
  9. ==========================================================================
  10.  
  11.  Der  Autor garantiert  weder die  Richtigkeit  noch die volle Funktions-
  12.  faehigkeit  der in dieser  Anleitung beschriebenen Funktionen von MSCal.
  13.  Weiterhin uebernimmt  er  keine  Haftung  fuer  Schaeden,  die durch die
  14.  Benutzung von  MSCal entstanden sind.  Die Benutzung von MSCal geschieht
  15.  auf eigenes Risiko !
  16.  
  17. ==========================================================================
  18.                                 I N H A L T
  19. ==========================================================================
  20.  
  21.             1. Einleitung
  22.                 1.1 Copyright
  23.                 1.2 Entstehungsgeschichte/Hintergruendiges
  24.             2. Bedienung von MSCal
  25.                 2.1 Starten vom CLI
  26.                 2.2 Starten von der Workbench
  27.                 2.3 Starten beim Hochfahren des Systems
  28.                 2.4 Arbeiten mit MSCal
  29.                 2.5 Allgemeines
  30.             3. Hinweise zum Compilieren
  31.             4. Verschiedenes
  32.             5. Zukunft
  33.             6. Bug's
  34.             7. Autor
  35.  
  36. ==========================================================================
  37.  
  38. ==========================================================================
  39.  1                              Einleitung
  40. ==========================================================================
  41.  1.1                             Copyright
  42. ==========================================================================
  43.  
  44.  MSCal ist  FreeWare.  Die Copyright-Rechte liegen  weiterhin beim Autor.
  45.  MSCal darf frei  kopiert werden,  solange diese Anleitung,  das Programm
  46.  und der Sourcecode unveraendert beiliegen.
  47.  
  48.  Der Sourcecode ist mit im Archiv enthalten,  darf aber nicht kommerziell
  49.  genutzt werden (hoechstens nach  Absprache mit dem Autor). Das Verwenden
  50.  einzelner Routinen in nicht-kommerziellen Public-Domain- bzw.  FreeWare-
  51.  Programmen ist aber dennoch gestattet, wenn der Autor davon unterrichtet
  52.  wird.   Die   Benutzung    einzelner   Routinen   in   Programmen,   die
  53.  militaerischen Zwecken dienen ist NICHT gestattet.
  54.  
  55.  Der Vertrieb von  MSCal  durch Public-Domain-Serien ist gestattet,  wenn
  56.  der Autor informiert wird,  auf welcher PD-Serie das Programm erscheint.
  57.  Es ist gestattet,  eine Kopiergebuehr   zur Deckung  der Unkosten zu er-
  58.  heben, solange  diese  den  Betrag  von  5,-- DM  (Fuenf  Deutsche Mark)
  59.  nicht uebersteigt. Die Diskette darf also inclusive Porto und Verpackung
  60.  nicht mehr als 5,-- DM kosten !
  61.  
  62.  Der Autor ist kleinen  materiellen Gaben und Geschenken nicht abgeneigt,
  63.  und weist auch Geldbetraege nicht zurueck. :-)
  64.  
  65. ==========================================================================
  66.  1.2              Entstehungsgeschichte/Hintergruendiges
  67. ==========================================================================
  68.  
  69.  MSCal ist entstanden,  weil ich oft  einen Kalender benoetigte und keine
  70.  Lust hatte,  erst einen Hardware-Kalender hervorzukramen.  Zuerst machte
  71.  ich mich auf die Suche nach  einem fertigen Kalenderprogramm,  habe aber
  72.  kein gescheites gefunden. Irgendwelche Macken hatten sie immer, und wenn
  73.  sie nur nicht richtig mit groesseren Fonts als Topaz 8 unter Kick/WB 2.0
  74.  klarkamen.
  75.  
  76.  Aehnliche  Probleme gab es  mit kleinen  Utilities,  die eine  Speicher-
  77.  anzeige  und eine  Uhr hatten.  MClk zum Beispiel  frisst viel  zu  viel
  78.  Rechenzeit und kommt  ausserdem mal wieder nicht mit anderen Fonts unter
  79.  Kick/WB 2.0 klar.
  80.  
  81.  Also blieb mir wohl nichts anderes  uebrig,  als solche Utilities selber
  82.  zu schreiben.  Dabei ist nun MSCal herausgekommen,  das beide  Utilities
  83.  miteinander vereint. Ich hoffe, dass es einigermassen fehlerfrei laeuft,
  84.  und  dass es  noch jemand  anderes ausser mir gebrauchen kann.  Ich habe
  85.  sogar von Leuten gehoert, die es angeblich freiwillig benutzen. :-)
  86.  
  87. ==========================================================================
  88.  2                        Bedienung von MSCal
  89. ==========================================================================
  90.  2.1                        Starten vom CLI
  91. ==========================================================================
  92.  
  93.  MSCal laesst sich vom CLI und von der WB aus starten. Der Aufruf vom CLI
  94.  sieht folgendermassen aus:
  95.  
  96.       MSCal [Option] [Option] [...]
  97.  
  98.  wobei folgende Optionen zur Verfuegung stehen:
  99.  
  100.       -x###   ### ist hierbei die x-Position des Kalenderfensters.
  101.       -y###   ### ist hierbei... na was wohl.
  102.       -u###   ### ist die x-Position des Clock-Windows.
  103.       -v###   ### ist die y-Position des Clock-Windows.
  104.       -f      Das Clock-Window legt sich automatisch immer in den
  105.               Vordergrund.
  106.       -b      Es wird zu jeder vollen Stunde ein DisplayBeep()
  107.               (Bildschirmblitz) aufgerufen.
  108.       -i      Das Programm wird gleich mit dem Clock-Window gestartet.
  109.  
  110.  Wird  eine unbekannte  Option angegeben  oder einfach nur "MSCal ?",  so
  111.  wird eine kleine  Hilfe ausgegeben.  MSCal loest  sich  nicht selbst vom
  112.  CLI,  sondern muss dazu mit Run bzw.  RunBack gestartet werden.  Fehler-
  113.  meldungen werden auf stdout ausgegeben.
  114.  
  115.  Ein Beispielaufruf waere:
  116.  
  117.       MSCal -x50 -y70 -f
  118.  
  119.  Der Kalender macht dann sein Fenster an  der Position 50/70 auf, und das
  120.  Clock-Window kann nicht von einem anderen Fenster verdeckt werden.
  121.  
  122.  Bei einem  Wert von -1 bei den  Positionen  wird  das Fenster moeglichst
  123.  weit rechts bzw. unten aufgemacht.
  124.  
  125. ==========================================================================
  126.  2.2                     Starten von der WorkBench
  127. ==========================================================================
  128.  
  129.  Zum Start von der Workbench muss man einfach nur das Icon anklicken.
  130.  
  131.  Natuerlich kann man ueber das Icon auch Parameter uebergeben. Diese muss
  132.  man bei den ToolTypes des Icons eintragen. Folgende ToolTypes stehen zur
  133.  Verfuegung:
  134.  
  135.      XPOS=###       ### ist hier wieder die x-Position des
  136.                     Kalenderfensters
  137.      YPOS=###       ### ist entsprechend die y-Position des
  138.                     Kalenderfensters
  139.      IXPOS=###      ### ist die x-Position des Clock-Windows
  140.      IYPOS=###      ### ist die y-Position des Clock-Windows
  141.      FLAGS=[Flags]  Folgende Flags stehen zur Verfuegung:
  142.                        FRONT   Das Clock-Window liegt immer
  143.                                im Vordergrund (entspricht -f)
  144.                        BEEP    Zur vollen Stunde wird DisplayBeep()
  145.                                aufgerufen (entspricht -b)
  146.                        ICONIFY Es wird mit dem Clock-Window gestartet
  147.                                (entspricht -i)
  148.  
  149.  Die Flags koennen  mit '|' kombiniert werden.  Folgende  ToolTypes  sind
  150.  also z.B. zulaessig:
  151.  
  152.       XPOS=-1 (Rechte Screenkante)
  153.       IYPOS=50
  154.       FLAGS=ICONIFY|FRONT
  155.  
  156.  Die   Schluesselwoerter  muessen  alle  in  Grossbuchstaben  geschrieben
  157.  werden, da  sie  sonst  nicht  erkannt werden.
  158.  
  159. ==========================================================================
  160.  2.3                Starten beim hochfahren des Systems
  161. ==========================================================================
  162.  
  163.  Unter  der Betriebssystemversion  2.0 gibt  es zwei  Moeglichkeiten, ein
  164.  Programm beim  hochfahren des Systems zu starten.  Einmal kann es in der
  165.  Startup-Sequence  (bzw. im  User-Startup)  aufgerufen  werden,  und  zum
  166.  anderen kann  das Icon des Programms in  das WBStartup-Directory kopiert
  167.  werden. Ein Aufruf in der Startup-Sequence sollte wie folgt aussehen:
  168.  
  169.       RunBack c:MSCal [Option] [...]
  170.  
  171.  oder:
  172.  
  173.       Run >nil: <nil: c:MSCal [Option] [...]
  174.  
  175.  Danach  kann  das  CLI-Fenster  problemlos  geschlossen  werden.  Dieses
  176.  funktioniert auch unter der Betriebssystemversion 1.3.
  177.  
  178.  Wenn MSCal in einem Verzeichnis liegt, das auch im Pfad eingetragen ist,
  179.  so  kann auch  das  Icon  von  MSCal in  das WBStartup-Directory k